home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / comm / ntmler8b.zip / NTMAIL.TXT < prev    next >
Text File  |  1996-09-25  |  7KB  |  176 lines
  1. NTMailer .80b
  2.  
  3. Introduction
  4. ------------
  5. First of all, this program is freeware.
  6.  
  7. NTMailer is a cgi program that runs only on NT based web servers.  With no experience
  8. with c/c++ or perl and a little knowledgeof HTML coding, you can write a full fledged 
  9. form that will be mailed to anyone you want in about 15 mins!  The program has the ability
  10. to mail the information to one or many and allows you to mail the person filling out the message 
  11. a canned response.
  12.  
  13. Features:
  14. ---------
  15.  
  16. -Design template file that has the look and feel of HTML coding.
  17. -Don't need to know a programming language like c/c++ or perl
  18. -All configuration parameters are done within the template file.
  19. -Has required fields with custom required error messages.
  20. -You design how the error html page will look like.
  21. -Can send form contents to to one or many people.
  22. -Can respond to the person with a canned 'thankyou' message or 'I will contact you soon'
  23. -Can send multiple response messages to several people (ie: 'your friend gave me your 
  24.  e-mail address, you might want to call him and give him a piece of your mind")
  25. -Multiple template files and only one cgi program
  26. -Design your own success page with standard HTML tags.
  27.  
  28. Remember
  29. --------
  30. As usual, with source code, you may modify it for your own needs, but you cannot redistribute it
  31. unless you have my expressed permission.
  32.  
  33.  
  34.  
  35. Installation
  36. ------------
  37. Put blat.exe, gwinsock.dll and ntmailer.exe into your cgi-bin directory.
  38.  
  39. Template file
  40. -------------
  41. The template file will go into your cgi-bin directory, as well.
  42.  
  43. <formdata>            ->Is where the form variables are processed.
  44. <name=".."            ->Name of the form variable
  45.   required            ->Is the field required or not
  46.   requiredErr=".."        ->If it is required and they leave the field empty, what is the err msg.
  47.   sendto            ->Send the results of this form to this e-mail address
  48.   respondto            ->Send a nice little response message to this person
  49.   respondMsg=".."        ->If 'respondto' is specified, what should I say?
  50.   output=".."            ->What text should appear in the e-mail to describe this information
  51.  .....
  52. </formdata>
  53.  
  54. <subject>...</subject>        ->e_mail subject line
  55. <smtpserver>...</smtpserver>    ->The SMTP Server we will be sending this stuff through.
  56. <sender>...</sender>        ->This is the e-mail address that the SMTP Server knows about.
  57.                   This is more or less like a SMTP Server login name.  Just remember,
  58.                   the server needs to know who this is.
  59. <succeedmsg>...</succeedmsg>    ->The message you will say on the next HTML page after they have 
  60.                   successfully filled out this form.  You are allow to use any standard
  61.                   HTML tags here in order to make it pretty.
  62. <errTemplate>...</errTemplate>  ->Using standard HTML tags, you can create a sort of template
  63.                   error page.  When you specify $err$, the tag will be replaced
  64.                   with the actual value specified in 'requiredErr'.
  65.  
  66. Here are the rules:
  67. 1.  If you specify a 'required' tag, then you should have a 'requiredErr' tag, otherwise it will provide a 
  68.     not-so-nice default error response.
  69. 2.  If you have a 'sendto' tag, you cannot have a 'output' tag.
  70. 3.  'sendto' and 'respondto' tags cannot co-exist in a single item.  
  71. 4.  If you have a 'respondto' tag, then you must have a 'respondMsg' tag.
  72. 5.  Tags are not case sensitive.  You can use any case you want.  I just like mixing my cases.  Habit.
  73. 6.  The 'sendto' tag will generate a log file (send.log).  This is primarily for debugging purposes to make sure the message was sent
  74. 7.  The 'respondto' tag will generate a log file (respond.log). This is primarily for debugging purposes to make sure the message was sent
  75.  
  76. Below is an example of a template file as well as the associated HTML form.  Learn by example, I always say.
  77.  
  78. Template file:  bugform
  79. --------------
  80.  
  81. <formdata>
  82.  
  83. <name="name" 
  84.  required 
  85.  requiredErr="Your name is Required.  Please enter you name" 
  86.  output="This is the name:">
  87.  
  88. <name="send_to"
  89.  required
  90.  requiredErr="I must have an e-mail address otherwise, who do I send this form to?"
  91.  sendto>
  92.  
  93. <name="e_mail"
  94.  required
  95.  requiredErr="I need your e-mail address, otherwise I will not know who you are."
  96.  respondto
  97.  respondmsg="Thanks for the business.  Someone will get back to you soon"
  98.  output="e_mail address:">
  99.  
  100. <name="phone" 
  101.  required 
  102.  requiredErr="Please enter you phone number." 
  103.  output="Phone number:">
  104.  
  105. </formdata>
  106.  
  107. <subject>SNTrax Web application</subject>
  108.  
  109. <smtpserver>mail.aracnet.com</smtpserver>
  110. <sender>ivanh@aracnet.com</sender>
  111.  
  112. <succeedmsg>
  113. <h1><center>Thankyou!</center></h1>
  114. <hr>
  115. Thanks for filling out this form, someone will contact you soon.
  116. <a href="/index.html">Click here </a> to go back to home.
  117. </succeedmsg>
  118.  
  119. <errTemplate>
  120. <bgcolor="#ffffff">
  121. <br><br><br>
  122. Error occured:<br>
  123. $err$
  124. Please push the back button and fix the problem.
  125. </body>
  126. </errTemplate>
  127.  
  128.  
  129. HTML form:
  130. ----------
  131. <html>
  132.  
  133. <head>
  134. <title>Example Form</title>
  135. </head>
  136.  
  137. <body>
  138. <form action="/cgi-bin/ntmailer.exe?bugform" method="POST">
  139. <h1 align=center>This is a sample form. Give a try.</h1>
  140. <p> </p>
  141. <div align=center><center>
  142. <table>
  143. <tr><td>Name: </td><td><input type=text size=22 maxlength=256 name="name"></td></tr>
  144. <tr><td>Send to:</td><td><select name="send_to" size=1>
  145. <option selected>ivanh@aracnet.com</option>
  146. <option>ivanh@hotmail.com</option>
  147. </select></td></tr>
  148. <tr><td>Your e-mail address:</td><td><input type=text size=20 maxlength=256 name="e_mail"></td></tr>
  149. <tr><td>Phone number:</td><td><input type=text size=12 maxlength=256 name="phone"> </td></tr>
  150. </table>
  151. </center></div>
  152. <p align=center><input type=submit name="Submitme" value="Submit Form"><input type=reset name="Resetme" value="Reset"></p>
  153. </form>
  154. </body>
  155.  
  156. </html>
  157.  
  158. I think I have all the rules.
  159. If something is missing, then please tell me.
  160.  
  161. Ivan Hendricks
  162. ivanh@aracnet.com
  163.  
  164. Copyright 1996 Ivan Hendricks.  All rights reserved
  165.  
  166. THIS SOFTWARE IS PROVIDED BY IVAN HENDRICKS "AS IS" AND             
  167. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE    
  168. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
  169. PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS 
  170. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
  171. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
  172. SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
  173. INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
  174. CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
  175. ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 
  176. THE POSSIBILITY OF SUCH DAMAGE.